home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libraw1394-11 / README < prev    next >
Text File  |  2008-07-05  |  2KB  |  64 lines
  1.  
  2.                    libraw1394
  3.                    ==========
  4.  
  5. 1. About libraw1394
  6.  
  7.     libraw1394 is the only supported interface to the kernel side raw1394 of
  8. the Linux IEEE-1394 subsystem, which provides direct access to the connected
  9. 1394 buses to user space.  Through libraw1394/raw1394, applications can directly
  10. send to and receive from other nodes without requiring a kernel driver for the
  11. protocol in question.
  12.  
  13.     The reason for making a library the interface to the kernel is to avoid
  14. a program dependancy on the kernel version, which would hinder development and
  15. optimization of raw1394.  If development changed the protocol and made it
  16. incompatible with previous versions only the libraw1394 has to be upgraded to
  17. match the kernel version (instead of all applications).
  18.  
  19.  
  20. 2. Copyleft
  21.  
  22.     libraw1394 itself is licensed under the Lesser General Public License
  23. (short LGPL, see file COPYING.LIB in the source distribution).  Other files in
  24. the source archives not belonging to but being part of the build procedure of
  25. libraw1394 are under their own licenses, as stated at the top of the individual
  26. files.
  27.  
  28.  
  29. 3. API documentation
  30.  
  31.     Finally there is something, in the doc subdirectory.  The file is
  32. libraw1394.sgml (it's Docbook format), and there are preformatted PostScript and
  33. HTML available.  This documentation is not complete yet.
  34.  
  35.  
  36. 4. Multithreading
  37.  
  38.     This library should be multithreadable with the restriction that one
  39. raw1394handle_t may be used only within a single thread.  Multiple threads
  40. operating on the same handle would royally mess up the kernel-user protocol.
  41. Simply use separate handles for each thread in which you need to use libraw1394.
  42.  
  43.  
  44. 5. Pkg-config
  45.  
  46.     The library comes with a pkg-config .pc file, so you can check for
  47. libraw1394 and its version in your configure script.  For example, here is how 
  48. to use the autoconf macro:
  49.  
  50. PKG_CHECK_MODULES(LIBRAW1394, libraw1394 >= 1.1.0)
  51.  
  52.     This macro sets the variables LIBRAW1394_CFLAGS and LIBRAW1394_LIBS.  You 
  53. have to include those into your build variables so that the build process 
  54. correctly links with libraw1394.
  55.  
  56.  
  57. 6. Maintainer
  58.  
  59.     Maintainer of libraw1394 is currently Dan Dennedy.  Send 
  60. suggestions, bug reports and fixes to linux1394-devel@lists.sourceforge.net.  
  61. See the file AUTHORS for a complete list of contributors to libraw1394.
  62.  
  63. Visit http://www.linux1394.org/ for more information or to see what is new.
  64.